<?php
/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category  Zend
 * @package   Zend_File_Transfer
 * @copyright  Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)
 * @license   http://framework.zend.com/license/new-bsd     New BSD License
 * @version   $Id: Transfer.php 23775 2011-03-01 17:25:24Z ralph $
 */

/**
 * @see Zend_Loader
 */
require_once 'Zend/Loader.php';

/**
 * Base class for all protocols supporting file transfers
 *
 * @category  Zend
 * @package   Zend_File_Transfer
 * @copyright  Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)
 * @license   http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_File_Transfer {
	/**
	 * Array holding all directions
	 *
	 * @var array
	 */
	protected $_adapter = array ();
	
	/**
	 * Creates a file processing handler
	 *
	 * @param  string  $adapter   Adapter to use
	 * @param  boolean $direction OPTIONAL False means Download, true means upload
	 * @param  array   $options   OPTIONAL Options to set for this adapter
	 * @throws Zend_File_Transfer_Exception
	 */
	public function __construct($adapter = 'Http', $direction = false, $options = array()) {
		$this->setAdapter ( $adapter, $direction, $options );
	}
	
	/**
	 * Sets a new adapter
	 *
	 * @param  string  $adapter   Adapter to use
	 * @param  boolean $direction OPTIONAL False means Download, true means upload
	 * @param  array   $options   OPTIONAL Options to set for this adapter
	 * @throws Zend_File_Transfer_Exception
	 */
	public function setAdapter($adapter, $direction = false, $options = array()) {
		if (Zend_Loader::isReadable ( 'Zend/File/Transfer/Adapter/' . ucfirst ( $adapter ) . '.php' )) {
			$adapter = 'Zend_File_Transfer_Adapter_' . ucfirst ( $adapter );
		}
		
		if (! class_exists ( $adapter )) {
			Zend_Loader::loadClass ( $adapter );
		}
		
		$direction = ( integer ) $direction;
		$this->_adapter [$direction] = new $adapter ( $options );
		if (! $this->_adapter [$direction] instanceof Zend_File_Transfer_Adapter_Abstract) {
			require_once 'Zend/File/Transfer/Exception.php';
			throw new Zend_File_Transfer_Exception ( "Adapter " . $adapter . " does not extend Zend_File_Transfer_Adapter_Abstract" );
		}
		
		return $this;
	}
	
	/**
	 * Returns all set adapters
	 *
	 * @param boolean $direction On null, all directions are returned
	 * On false, download direction is returned
	 * On true, upload direction is returned
	 * @return array|Zend_File_Transfer_Adapter
	 */
	public function getAdapter($direction = null) {
		if ($direction === null) {
			return $this->_adapter;
		}
		
		$direction = ( integer ) $direction;
		return $this->_adapter [$direction];
	}
	
	/**
	 * Calls all methods from the adapter
	 *
	 * @param  string $method  Method to call
	 * @param  array  $options Options for this method
	 * @return mixed
	 */
	public function __call($method, array $options) {
		if (array_key_exists ( 'direction', $options )) {
			$direction = ( integer ) $options ['direction'];
		} else {
			$direction = 0;
		}
		
		if (method_exists ( $this->_adapter [$direction], $method )) {
			return call_user_func_array ( array ($this->_adapter [$direction], $method ), $options );
		}
		
		require_once 'Zend/File/Transfer/Exception.php';
		throw new Zend_File_Transfer_Exception ( "Unknown method '" . $method . "' called!" );
	}
}
